home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / winsock / xplan03.zip / READ.ME < prev    next >
Text File  |  1995-06-24  |  6KB  |  143 lines
  1.  
  2.                    XPLAN -- AUTOMATE UPDATING OF .PLAN FILE
  3.                                        
  4.    XPlan version 0.3 Built day: June 24, 1995
  5.    
  6. What's XPlan?
  7.  
  8.    If you are using dynamic address, it's real hard for your friends to
  9.    find out what address you are using or even if your are online or not.
  10.    You can use XPlan to upload your dynamic address to your .plan file in
  11.    an account in a permanent host(like your account in your Internet
  12.    provider) everytime you login or logout of a SLIP/PPP section.
  13.    
  14. Requirement:
  15.  
  16.    You need VBRUN300.DLL to run this program, also MS-Windows3.1(or up)
  17.    running Winsock 1.1 or up.
  18.    
  19. Installation:
  20.  
  21.    After unzip the package into a directory, run setup.exe from that
  22.    directory under MS-Windows.
  23.    
  24. Command Line Options:
  25.  
  26.    XPlan receives two command line options: log_in and log_out. Why these
  27.    two? read on for more details.
  28.    
  29. Running:
  30.  
  31.    If you run XPlan for the first time, it will need some information
  32.    about you and your remote account. That includes the name of remote
  33.    host you want to put the .plan file, your login ID on that host, your
  34.    password on that host, and the name you prefer to be called. You enter
  35.    these only once. XPlan will save this to a file and load them next
  36.    time you run XPlan again. If XPlan successfully update your remote
  37.    .plan file, your .plan file will look like this:
  38.    My local address is your_name@your_local_host_name
  39.    For compatible reason, you shouldn't specify your name longer than 12
  40.    characters. Your friends who finger(using any finger client, e.g. my
  41.    Xfinger) your UNIX account can know if you are online or not, and
  42.    where are you. Then he/she can talk to you by typing
  43.    talk your_name@your_local_host_name.
  44.    (I also have a talk client, xtalk. I am working on server part right
  45.    now).
  46.    If you want to add more texts on top of that one line message in the
  47.    same .plan file, you can put them in a file called xplan.txt in the
  48.    directory where you installed xplan. XPlan.txt along with the above
  49.    message will be your .plan file. I provided a simple xplan.txt with
  50.    this package. You should modify it to suit your need.
  51.    
  52. Script File:
  53.  
  54.    I am using trumpet winsock. The following example is done in that
  55.    script language. Other Winsock script language should have similar
  56.    functions. In trumpet, you can execute a program using "exec" command
  57.    in you script. To automate updating of your .plan file, you can put an
  58.    "exec" right after the part that winsock fires up SLIP function.
  59.    exec "c:\xplan\xplan.exe log_in"
  60.    Of course, you should modify the path if you installed xplan in a
  61.    different path. This will put that magic
  62.    message(your_name@your_local_host_name) in your remote .plan file. For
  63.    some reasons, you can not execute a program in Trumpet's bye.cmd.
  64.    Therefore, to update .plan file when you logout of a section, you have
  65.    to click on Logout option in XPlan. XPlan will first upload a new
  66.    .plan file to remote host without magic message. Then it will
  67.    disconnect Trumpet for you automatically.
  68.    If you use other Winsock stacks, XPlan will not disconnect winsock
  69.    connection automatically(it still update your .plan file). I will
  70.    revise this limitation when I have time.
  71.    Of course, if you don't want to run xplan from your script file, you
  72.    still can launch it from program manager.
  73.    
  74. Supporting Files
  75.  
  76.    There are two files you need to put in right directory, xplan.ini and
  77.    xplan.txt. If you run XPlan from login.cmd, you should put them into
  78.    the directory where you run tcpman.exe. If you run XPlan from command
  79.    line(i.e. from program manager), you should put them in the same
  80.    directory as where you put XPlan.exe.
  81.    
  82. Problems?
  83.  
  84.    Before you use XPlan, you should make sure that the permission of your
  85.    original .plan file is 644, i.e. world readable. To change permission
  86.    of this file, typing chmod 644 ~/.plan in your UNIX account. You
  87.    should make a .plan file and set it to that permission if you do not
  88.    have one. Because the permission of new .plan will be the same as the
  89.    permission of old one.
  90.    
  91. Security Issue:
  92.  
  93.    This program needs your password to run. The reason is obvious. It
  94.    needs to gain access to your account inorder to update your .plan
  95.    file. I try the best I can to hide your password(using encryption).
  96.    Some things you should know:
  97.    1. Never get this package(XPlan) from unknown sites. The best place to
  98.    get it is my WWW
  99.    page(http://www.ugrad.cs.ubc.ca/spider/q7f192/tools.html). I will also
  100.    upload it to SimTel and CICA.
  101.    2. Never expose xplan.ini to anyone. That file contains encrypted
  102.    password. Somebody might try to decrypt it.
  103.    3. Change your password often.
  104.    Did I mention how to change password for xplan. For now, you have to
  105.    delete the entry in xplan.ini inorder to enter new data for that
  106.    entry(you name, your host, etc.). Delete the whole line contains that
  107.    entry, the next time xplan will ask you to enter that entry again. I
  108.    might add some functions to do that inside of xplan.
  109.    
  110. Availability
  111.  
  112.    Latest XPlan can be found at:
  113.     http://www.ugrad.cs.ubc.ca/spider/q7f192/branch/tools.html
  114.    
  115.    Did I mention that this program is FREE!
  116.    
  117.    DISCLAIMER: I AM NOT RESPONSIBLE FOR ANY DAMAGE THAT THIS PROGRAM MAY
  118.    CAUSE. YOU USE IT ON YOUR OWN RISK!
  119.    
  120.    All brand names and trademarks are the property of their respective
  121.    owners
  122.    
  123.     _________________________________________________________________
  124.    
  125.     XPlan Copyright (C) 1995
  126.     George Xie / q7f192@ugrad.cs.ubc.ca
  127.  
  128.  
  129. FILE_ID.DIZ
  130.  
  131. (V0.3) XPlan - Win File/Winsock
  132. Xplan can update your .plan file everytime 
  133. you log into your SLIP/PPP connection. 
  134. XPlan adds a a message at the end of your
  135. .plan file indicating what's your current
  136. address. When you logout, the .plan file is
  137. also updated to get rid of that message.
  138. It's very useful for dynamic address users,
  139. also for permanent address owners.
  140. It's freeware
  141. George Xie,  q7f192@ugrad.cs.ubc.ca
  142. http://www.ugrad.cs.ubc.ca/spider/q7f192
  143.